.TH std::time_get_byname 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::time_get_byname \- std::time_get_byname

.SH Synopsis
   Defined in header <locale>
   template<

       class CharT,
       class InputIt = std::istreambuf_iterator<CharT>

   > class time_get_byname : public std::time_get<CharT, InputIt>

   std::time_get_byname is a std::time_get facet which encapsulates time and date
   parsing rules of the locale specified at its construction.

.SH Specializations

   The standard library is guaranteed to provide every specialization that satisfies
   the following type requirements:

     * CharT is one of char and wchar_t, and
     * InputIt must meet the requirements of LegacyInputIterator.

.SH Member types

   Member type Definition
   char_type   CharT
   iter_type   InputIt

.SH Member functions

   constructor   constructs a new time_get_byname facet
                 \fI(public member function)\fP
   destructor    destroys a time_get_byname facet
                 \fI(protected member function)\fP



std::time_get_byname::time_get_byname

   explicit time_get_byname( const char* name, std::size_t refs = 0 );
   explicit time_get_byname( const std::string& name, std::size_t refs =  \fI(since C++11)\fP
   0 );

   Constructs a new std::time_get_byname facet for a locale with name.

   refs is used for resource management: if refs == 0, the implementation destroys the
   facet, when the last std::locale object holding it is destroyed. Otherwise, the
   object is not destroyed.

.SH Parameters

   name - the name of the locale
   refs - the number of references that link to the facet



std::time_get_byname::~time_get_byname

   protected:
   ~time_get_byname();

   Destroys the facet.

Inherited from std::time_get

   Member type Definition
   char_type   CharT
   iter_type   InputIt

.SH Member objects

   Member name Type
   id (static) std::locale::id

.SH Member functions

   date_order    invokes do_date_order
                 \fI(public member function of std::time_get<CharT,InputIt>)\fP
   get_time      invokes do_get_time
                 \fI(public member function of std::time_get<CharT,InputIt>)\fP
   get_date      invokes do_get_date
                 \fI(public member function of std::time_get<CharT,InputIt>)\fP
   get_weekday   invokes do_get_weekday
                 \fI(public member function of std::time_get<CharT,InputIt>)\fP
   get_monthname invokes do_get_monthname
                 \fI(public member function of std::time_get<CharT,InputIt>)\fP
   get_year      invokes do_get_year
                 \fI(public member function of std::time_get<CharT,InputIt>)\fP
   get           invokes do_get
   \fI(C++11)\fP       \fI(public member function of std::time_get<CharT,InputIt>)\fP

.SH Protected member functions

   do_date_order     obtains preferred ordering of day, month, and year
   \fB[virtual]\fP         \fI\fI(virtual protected member function\fP of\fP
                     std::time_get<CharT,InputIt>)
   do_get_time       extracts hours, minutes, and seconds from input stream
   \fB[virtual]\fP         \fI\fI(virtual protected member function\fP of\fP
                     std::time_get<CharT,InputIt>)
   do_get_date       extracts month, day, and year from input stream
   \fB[virtual]\fP         \fI\fI(virtual protected member function\fP of\fP
                     std::time_get<CharT,InputIt>)
   do_get_weekday    extracts the name of a day of the week from input stream
   \fB[virtual]\fP         \fI\fI(virtual protected member function\fP of\fP
                     std::time_get<CharT,InputIt>)
   do_get_monthname  extracts a month name from input stream
   \fB[virtual]\fP         \fI\fI(virtual protected member function\fP of\fP
                     std::time_get<CharT,InputIt>)
   do_get_year       extracts a year from input stream
   \fB[virtual]\fP         \fI\fI(virtual protected member function\fP of\fP
                     std::time_get<CharT,InputIt>)
                     extracts date/time components from input stream, according to the
   do_get            specified format
   \fB[virtual]\fP \fI(C++11)\fP \fI\fI(virtual protected member function\fP of\fP
                     std::time_get<CharT,InputIt>)

Inherited from std::time_base

   Type      Definition
   dateorder date order enumeration type, defining the values no_order, dmy, mdy, ymd,
             and ydm

.SH Example

    This section is incomplete
    Reason: no example

.SH See also

   time_get parses time/date values from an input character sequence into std::tm
            \fI(class template)\fP
   get_time parses a date/time value of specified format
   \fI(C++11)\fP  \fI(function template)\fP

.SH Category:
     * Todo no example
